package com.wangqiang.config;

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import springfox.documentation.builders.PathSelectors;
import springfox.documentation.builders.RequestHandlerSelectors;
import springfox.documentation.service.ApiInfo;
import springfox.documentation.service.Contact;
import springfox.documentation.spi.DocumentationType;
import springfox.documentation.spring.web.plugins.Docket;
import springfox.documentation.swagger2.annotations.EnableSwagger2;

import java.util.ArrayList;

/**
 * @author 李星
 * @date 2020/7/30 11:12
 */
@Configuration
@EnableSwagger2
public class SwaggerConfig {

    //配置Swagger的docket具体参数
    @Bean
    public Docket docket() {
        return new Docket(DocumentationType.SWAGGER_2)
                .apiInfo(apiInfo())
/*                 通过.select()方法，RequestHandlerSelectors配置如何扫描接口
                    basePackage：指定要扫描的包
                    any:扫描全部
                    none:全不扫描
                    withMethodAnnotation(GetMapping.class):通过方法上的注解扫描 只扫描get请求
                    withClassAnnotation(Controller.class):只扫描有controller注解的类中的接口
                   */
                .groupName("李星")
                .select()
                .apis(RequestHandlerSelectors.basePackage("com.wangqiang.controller"))
                /*   配置如何通过path过滤,即这里只扫描请求以/kuang开头的接口
                     .paths(PathSelectors.ant("/kuang/**")) */
                .build();
    }

    //配置Swagger信息=apiInfo
    private ApiInfo apiInfo() {
        //作者信息
        Contact contact = new Contact("李星", "http://baidu.com", "1337983798@qq.com");
        return new ApiInfo(
                "Swagger学习", // 标题
                "学习演示如何配置Swagger", // 描述
                "v1.0", // 版本
                "http://terms.service.url/", // 组织链接
                contact, // 联系人信息
                "Apach 2.0 许可", // 许可
                "许可链接", // 许可连接
                new ArrayList<>()// 扩展
        );
    }
}
